home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 4 / CU Amiga Magazine's Super CD-ROM 04 (1996)(EMAP Images)(GB)(Track 1 of 3)[!][issue 1996-11].iso / magazine / psion / utils / morph4.lzx / ReadMe.txt
Text File  |  1996-09-20  |  9KB  |  241 lines
  1. Morphodite, (c) 1995,1996 Ben Clifford (benc@donor2.demon.co.uk)
  2.  
  3. revision 7: 25 May 1996 (release 4)
  4. revision 3: 19 March 1996
  5. original: 30 December 1995
  6.  
  7. Contents:
  8.  
  9.  1 What is Morphodite?
  10.  2 How does Morphodite work?
  11.  3 How do I install Morphodite?
  12.  4 How do I use Morphodite?
  13.  5 What types does Morphodite support by default?
  14.  6 Templates
  15.  7 Is Morphodite freeware?
  16.  8 How do I add applications to Morphodite?
  17.  9 MORPHALS.ODB
  18. 10 MorphShadow
  19.  
  20. You do not need to read or understand all sections of this document in
  21. order to be able to effectively use Morph - the later sections provide
  22. technical details to other hackers.
  23.  
  24. What is Morphodite?
  25. ===================
  26.  
  27. Morphodite is an application which allows you to have icons for a
  28. specific topic, instead of for a specific application.
  29.  
  30. Under a Morphodite icon, you can have files of (almost) any type, all
  31. mixed up together.
  32.  
  33. An example of how I use this myself:
  34. I have one icon for each subject at school: Maths, Physics, Chemistry,
  35. Electronics. Under Physics, I can put spreadsheets of experimental
  36. results. I can also put Word documents of notes about the experiments.
  37.  
  38. The files appear under one Physics specific list, instead of being
  39. mixed up amongst all my other sheet and word documents.
  40.  
  41. Morphodite also allows you to have template documents, even for applications
  42. that do not normally support templates.
  43.  
  44. How does Morphodite work?
  45. =========================
  46.  
  47. When you open a file under a morphodite list on the system screen,
  48. Morphodite is run and told the name of the data file. It then inspects
  49. this datafile and determines what type it is by the signature at the
  50. start of the file. It looks up in its database (MORPH.ODB) which
  51. application is associated with that type and opens the datafile using
  52. that application, but putting it under the Morphodite list instead of
  53. under the normal list for that application. The initial Morphodite
  54. program then exits, leaving the application ready for use.
  55.  
  56. How do I install Morphodite?
  57. ============================
  58.  
  59. The files in the supplied archive are already split up into the
  60. appropriate directories. Copy them onto the internal disk of your
  61. Psion into the same directories.
  62.  
  63. In case you lose the directories somehow:
  64.  
  65. \app\MORPH.OPA
  66. \opd\MORPH.ODB
  67. \opd\MORPHALS.ODB
  68. \morph\CALC.MOR
  69. \morph\SPELL.MOR
  70. \morph\SPY.MOR
  71.  
  72. How do I use Morphodite?
  73. ========================
  74.  
  75. If you install morph.opa, you will be given a blank document icon,
  76. under which .MOR files in the \MORPH\ subdirectory will appear - by
  77. default this includes some sample MorphShadows, which you can safely
  78. delete.
  79.  
  80. You can use this list by itself if you only wish to have one list, or
  81. you can create new Morphodite lists in the usual manner by choosing
  82. "Create new list" on the System screen and specifying a different
  83. directory or extension.
  84.  
  85. In order to make existing files appear under a morphodite list, you must
  86.   i) move the file into the correct directory (\MORPH\ by default)
  87.  ii) change the extension to the morphodite extension (.MOR by default)
  88.  
  89. When you choose "New File" on the system screen, Morphodite will bring
  90. up a dialog box allowing you to choose the type of data file you wish
  91. to create.
  92.  
  93. What types does Morphodite support by default?
  94. ==============================================
  95.  
  96. MORPH.ODB initially contains entries for the following Series 3a applications:
  97.  Agenda
  98.  Data
  99.  Spreadsheet
  100.  Word
  101.  Record (eg .wve files)
  102.  World
  103.  Comms (but not script editor)
  104.  OPL source code beginning APP, PROC or REM
  105.  OPO object files
  106.  IconEd icons
  107.  
  108. Templates
  109. =========
  110.  
  111. The template feature allows you to create documents based on
  112. templates, instead of just creating a new blank one of the chosen type
  113. - for example on my Money list, I have a BANKACCT template for new
  114. bank accounts and a MEAL template for meals where one person pays to
  115. keep track of how much people owe.
  116.  
  117. It works as follows:
  118. When you choose to create a new document, in addition to available
  119. normal types, such as Word or Sheet, at the top of the list appear any
  120. available templates. If you choose a template, then Morph copies the
  121. template to the filename you are creating and opens it.
  122.  
  123. A template file can be any file that Morphodite can open normally. It
  124. should have the extension .MTP instead of .MOR. Template files are
  125. specific to the directory that you are working in - a template file in
  126. \MONEY\ will only appear when I create a new file under list that uses
  127. \MONEY\ for its data files.
  128.  
  129. An easy way to create the template is to create a normal Morph file
  130. of the desired type, then make suitable adjustments and entries. After
  131. exiting it, on the system screen, choose File->Rename and rename
  132. "MYTEMPL" to "MYTEMPL.MTP". The file will disappear from the list but
  133. when you create a new file under that list, MYTEMPL will appear in the
  134. Application: dialog box.
  135.  
  136. Is Morphodite freeware?
  137. =======================
  138.  
  139. Yes. Morphodite is distributed with no guarantees and no charge - you
  140. may distribute and use it freely.
  141.  
  142. If you are not careful about filling in the fields correctly in
  143. MORPH.ODB and MORPHALS.ODB, it is possible to crash your Psion.
  144.  
  145. There is very little error checking in Morphodite, as I have developed
  146. it as a personal project and have decided to release it because I
  147. think others might find it useful.
  148.  
  149. Please send me comments/criticism/compliments (and if you want to send
  150. me money, sterling cheques payable to B. Clifford, 7 Broke Court,
  151. Guildford GU4 7HQ)
  152.  
  153. **** FROM NOW ONWARDS IS TECHNICAL STUFF THAT NORMAL PEOPLE DON'T NEED
  154. **** TO READ
  155.  
  156.  
  157. How do I add applications to Morphodite?
  158. ========================================
  159.  
  160. NOTE: The datafile must have a unique signature at the very start of
  161. the file identifying its type. This means that you cannot have, say,
  162. arbitary text files under a Morphodite list. However, if your text
  163. files all begin with the same string, then you can use them.
  164.  
  165. To add an application, open \OPD\MORPH.ODB in Data, add a record and
  166. fill in the five fields:
  167.  
  168. sig$: The signature at the start of the file. This can be up to sixteen
  169.       characters.
  170.  
  171. app$: The full path and name of the application which will be used to handle
  172.       this type of data file
  173.  
  174. desc$: A brief (eg one or two words) name for the type, which will be used
  175.        when you choose to create a New file.
  176.  
  177. ListT$: The name of the list on the system screen which files of this
  178.         type would normally come under.
  179.  
  180. alias$: The alias information to be passed to the application.
  181.         Normally, leave this blank. It is used, as can be seen in the
  182.         supplied MORPH.ODB, to cause the Word-Processor to go into
  183.         different modes, such as Program Editor mode.
  184.  
  185.  
  186. MORPHALS.ODB
  187. ============
  188.  
  189. MORPHALS.ODB allows files opened under one list to appear under
  190. another list when it is opened.
  191. When you open a file under list "x", this list "x" is looked up in
  192. MORPHALS.ODB and if found (along with it's corresponding name "y"),
  193. the file is then opened under list "y". If "x" is not in MORPHALS.ODB,
  194. then the file is opened as normal.
  195.  
  196. An example, going back to my school-work, I have another list, School,
  197. which has the Agenda button attached to it. Files under
  198. Physics, Maths, Chem or Electr will be opened under School, so I can
  199. use the Agenda button to switch to any open school-related file.
  200.  
  201.  
  202.  
  203. MorphShadow
  204. ============
  205.  
  206. MorphShadow allows you to (rather crudely at the moment) create aliases
  207. to run applications, without them being in the Morphodite directory.
  208.  
  209. An example of how I use this is I have a "Calc Button" morph list,
  210. assigned to my Calc application button. Under this list, I have
  211. MorphShadows for Calc, Spell and Spy. Also under this list, I have my
  212. normal World application datafile (renamed to World.MOR).
  213.  
  214. This allows me to cut the number of installed icons down by 3, freeing
  215. up system resources, and, more importantly, allows me to cycle around
  216. them using the only Calc button.
  217.  
  218. To use MorphShadow: Create a new Morph file as usual, and choose the
  219. MorphShadow type. A dialog box will appear allowing you to enter details
  220. of the application: The image filename (eg ROM::calc.app), any alias
  221. information (eg. if you want to start the text editor in special modes;
  222. just leave blank normally), datafile (also can be left blank for apps
  223. like Calc with no file), appfile (this can be left blank for almost
  224. everything except running OPL code via MorphShadow).
  225.  
  226. To edit a MorphShadow, choose New file from the system screen, enter the
  227. appropriate filename, answer Yes to Overwrite, reselect MorphShadow. The
  228. previous details will be brought up in the dialog box, for editing.
  229.  
  230. MorphShadow is a basic interface to FilExecute as found in Psionics
  231. syscalls.1, and reading that might help you understand what you are
  232. doing.
  233.  
  234. **** If you don't understand, don't mess with this feature - you will
  235. **** be likely to lose data!
  236.  
  237.  
  238. Ben Clifford
  239. benc@donor2.demon.co.uk
  240.  
  241.